Day 16: Vue的無渲染元件 - slot props 的另一種常見用法 - iT 邦幫忙::一起幫忙解決難題，拯救 IT 人的一天

2024 iThome 鐵人賽

DAY 16

JavaScript

Vue.js學習中的細節陷阱：30天自我學習指南系列第 16 篇

Day 16: Vue的無渲染元件 - slot props 的另一種常見用法

16th鐵人賽 vue.js vue3

Rafael

2024-09-29 15:51:41

111 瀏覽

分享至

在昨天寫完文章時，更加認識了Vue的slot插槽和當初不太理解的slot props用法，後來翻了一下Vue的設計模式(Vue Pattern)文章，有提到無渲染元件(renderless component)，是一種需要結合slot props的另一種比較常見的應用，今天就來實作和重新理解一下吧。

今日學習目標

理解什麼是無渲染元件(renderless component)
無渲染元件Tab切換按鈕實作-另一個slot props實際應用案例

無渲染元件

無渲染元件（Renderless component)是一種 Vue的設計模式，主要概念有點像昨天結尾提到，將元件的商業互動邏輯(Logic)與UI樣式展示層(View)完全分離，這樣既可以封裝功能，又不影響視覺呈現。

無渲染元件本身會專注於某些互動行為邏輯上，基本上沒有樣板(Template)，而將實際的渲染交由父元件處理，程式碼上通常只有共用的JS互動邏輯(script)，這種模式在需要不同 UI 實現，但使用相同邏輯時特別有用，能避免重複編寫相同的邏輯代碼，實現更靈活的重用。

Tab 切換按鍵

用上次找的無渲染元件文章範例來練習吧~

像下面的Tab切換鍵有3種不一樣的UI款式，功能面上會有點擊事件和一個切換點擊的狀態:

一開始我們拿到樣式可能會習慣先開發成3種獨立元件，不過細細分析後會發現在點擊事件的互動邏輯上，這3種UI元件其實是相同的，它們其實只有template部分是不一樣的，讓我們步調放慢，一步步重構看起來有點重複性的動作。

useCheckBox - 點擊事件共用邏輯重構

首先可以將點擊事件的點選checked狀態的共用邏輯抽離變成一個組合式函式(composable)，這麼一來其他元件在用到相同邏輯時就能重複利用，而不是重複地綑在Vue元件檔裡面，這樣我們的第一步checkbox UI重構就算完成。

// useCheckBox.js
import { ref } from "vue";

export function useCheckboxToggle() {
  const checkbox = ref(false); // 點擊狀態是否點擊到
  
  // 點擊互動事件
  const toggleCheckbox = () => {
    checkbox.value = !checkbox.value;
  };

  return {
    checkbox,
    toggleCheckbox,
  };
}

// 引入checkbox元件中使用

<template>
  <div class="comp">
    <label class="switch">
      <input type="checkbox" :value="checkbox" @click="toggleCheckbox" />
      <div class="slider rounded" :class="checkbox ? 'active' : ''"></div>
    </label>
  </div>
</template>

<script setup>
  import { useCheckboxToggle } from "./composables/useCheckboxToggle";

  const { checkbox, toggleCheckbox } = useCheckboxToggle();
</script>

利用 slot props 將子元件checked狀態傳送給父元件

上面有提到我們有相同的點擊邏輯，但UI樣版的樣式要3種，需要開啟給開發者做決定，其實跟上次提到的插槽slot應用很像，我們可以試著把剛剛重構程式碼變成插槽看看:

// 共用的checkbox UI元件
<template>
  <div class="comp">
   <slot></slot>  // 這裡讓父層決定template要顯示什麼
  </div>
</template>

<script setup>
  import { useCheckboxToggle } from "./composables/useCheckboxToggle";

  const { checkbox, toggleCheckbox } = useCheckboxToggle();
</script>

接著我們就要考量，如何將useCheckboxToggle的點擊狀態和互動點擊事件，透過插槽props(slots props)傳遞給父元件，並由父元件負責如何自己定義客製化樣板UI。

<template>
  // 這裡連接上子元件定義好的狀態，拋接給外層父元件使用
  <slot :checkbox="checkbox" :toggleCheckbox="toggleCheckbox"></slot>
</template>

<script setup>
  import { ref } from "vue";

  const checkbox = ref(false);

  const toggleCheckbox = () => {
    checkbox.value = !checkbox.value;
  };
</script>

父元件利用slot組裝成不同客製化UI

接著就可以統一在父層去設計不同樣式的Tab按鈕UI-範例(可以點進去參考)

<template>
  <ToggleComponent v-slot="{ checkbox, toggleCheckbox }">
    <div class="comp">
      <label class="switch">
        <input type="checkbox" :value="checkbox" @click="toggleCheckbox" />
        <div class="slider rounded" :class="checkbox ? 'active' : ''"></div>
      </label>
    </div>
  </ToggleComponent>

  <!-- Toggle element 2 -->
  <ToggleComponent v-slot="{ checkbox, toggleCheckbox }">
    <div class="comp">
      <button class="toggle-button" @click="toggleCheckbox">
        Toggle | <span>{{ checkbox ? "Yes 😀" : "No 😔" }}</span>
      </button>
    </div>
  </ToggleComponent>
</template>

<script setup>
  import ToggleComponent from "./components/ToggleComponent";
</script>

UI library 客製化樣式-slot props

其實很多工作上用到的UI元件庫，當我們需要對它進行客製化調整時也是運用同樣slot props，提供一個窗口給開發者客製化自己的UI元件，但同時保有元件庫提供的互動功能。

像是常用的PrimeVue的客製化分頁器(Paginator):

滿清楚是利用slot props 提供給使用者去接受分頁器裡包裝好的分頁狀態，開發者則可以在slot插槽內客製化自己想要的UI。


<Paginator :rows="10" :totalRecords="120" :rowsPerPageOptions="[10, 20, 30]">
    <template #start="slotProps">
        Page: {{ slotProps.state.page }}
        First: {{ slotProps.state.first }}
        Rows: {{ slotProps.state.rows }}
    </template>
    <template #end>
        <Button type="button" icon="pi pi-search" />
    </template>
</Paginator>